package com.youlai.boot.modules.game.service;

import com.baomidou.mybatisplus.extension.plugins.pagination.Page;
import com.youlai.boot.modules.game.model.query.GameUserInfoQuery;
import com.youlai.boot.modules.game.model.vo.GameUserInfo;

import java.util.List;
import java.util.Map;

/**
 * 游戏用户信息服务接口
 */
public interface GameUserInfoService {

    /**
     * 获取用户信息分页列表
     *
     * @param queryParams 查询参数
     * @return 用户信息分页列表
     */
    Page<GameUserInfo> getUserInfoPage(GameUserInfoQuery queryParams);

    /**
     * 获取用户信息详情
     *
     * @param id 用户ID
     * @return 用户信息详情
     */
    GameUserInfo getUserInfo(Long id);

    /**
     * 获取用户游戏类型分布
     *
     * @param userId 用户ID
     * @return 游戏类型分布数据
     */
    List<Map<String, Object>> getGameTypeDistribution(Long userId);

    /**
     * 获取用户活跃度分布
     *
     * @return 活跃度分布数据
     */
    List<Map<String, Object>> getActivityDistribution();

    /**
     * 获取每月新增用户趋势
     *
     * @param months 月数
     * @return 月度趋势数据
     */
    List<Map<String, Object>> getMonthlyTrend(Integer months);

    /**
     * 获取用户游戏时长分布
     *
     * @return 游戏时长分布数据
     */
    List<Map<String, Object>> getPlayTimeDistribution();

    /**
     * 导出用户数据
     *
     * @param queryParams 查询参数
     * @return 导出文件URL
     */
    String exportUserData(GameUserInfoQuery queryParams);

    /**
     * 导出分析报告
     *
     * @return 导出文件URL
     */
    String exportAnalysisReport();
} 